home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / game / role / hs14c.lha / Hack&Slash.doc < prev    next >
Text File  |  1993-03-14  |  8KB  |  181 lines
  1.                                 Hack & Slash
  2.                                 by Rob Hurst
  3.                                 Mark Montminy
  4.                                & Lonnie Watson
  5.  
  6. Installation:
  7.  
  8.    Hack & Slash should be placed in it's own directory.  I'd suggest locating
  9.    it in your main doors directory, but it's fully up to you.  No assigns
  10.    are necessary (more doors should be so kind), it will find it's files
  11.    according to the path it was launched from.
  12.  
  13.    (door programmers, read argv[0] and put an end to this assign nonsense!)
  14.  
  15.    Extract the archive with it's full path, and all files will be placed where
  16.    they belong for proper execution of the game.
  17.  
  18. Launching Hack & Slash:
  19.  
  20.    Depending on your BBS system, this will be different.  Most BBS' will be
  21.    running in standard i/o mode.  Do whatever magic is required of your BBS
  22.    system to start the game as a standard CLI program.  H&S expects a CTRL-C
  23.    break signal upon carrier loss or timeout, and will exit cleanly.
  24.    The command line should be:
  25.  
  26.    drive:doorpath/hack&slashpath/hack&slash <options> user_id
  27.  
  28.    Note the user_id.  This IS needed.  It may be the user's name, handle,
  29.    phone number, user number, or anything else UNIQUE to each user.  The game
  30.    uses it's own "handles" and simply uses this as a means to identify the
  31.    user playing.  It will read everything after the options as the user_id,
  32.    so the name need not be enclosed in "", or any other such nonsense.
  33.  
  34.    Options:
  35.  
  36.       -c Disables "back to back" plays.  A user must wait till another user
  37.          plays (or midnight is crossed) before playing again.  It helps keep
  38.          the game fair.  Without it, users can play as many turns as they have,
  39.          in a row.
  40.          Default is off, back to back plays are allowed.
  41.  
  42.       -x Run in Xenolink mode.  This forces H&S to run as a XenolinkDoor under
  43.          Xenolink since CLIdoor just had too many problems.  Standard Xenolink
  44.          syntax applies.  Note that this MUST be followed immediately with a
  45.          ~20 in order to work, ie -x~20.
  46.          The entry I use is:
  47.  
  48.             XenolinkDoor "^30000^1Hack&Slash/Hack&Slash -x~20 ~100"
  49.  
  50.    Hack & Slash should only be played by one node at a time.  A locking
  51.    mechanism has been used ensure that only one copy is in use at a time.
  52.    
  53.    When Hack&Slash starts up, it will take the base directory name, and create
  54.    an ENV variable with that name.  It will check for the existance of this
  55.    ENV before running.  If found, it means another copy is in use.  A message
  56.    will be displayed and the door will exit.  It it's not found, it is
  57.    created and the game starts.
  58.  
  59.    Note that you CAN have more than one H&S game going at once as long as
  60.    they each have thier own complete set of data files and executable in
  61.    seperate directories.
  62.  
  63.    Make sure YOU are the 1st person to play each and every game.  The 1st
  64.    player is the "sysop" of the game and has the ability to edit and delete
  65.    other players.  The "sysop" menu is activated via the @ key from the main
  66.    menu.
  67.  
  68.    There is a directory with some sample startup scripts in it for launching
  69.    H&S under some of the various BBS packages out there.  I'd like to thank
  70.    the following for thier contributions to this effort:
  71.  
  72.       Roger Clarke - for his TransAmiga startup script
  73.       Bill Seymour - for his BBX scripts
  74.       Alan Bland   - for answering my stupid questions all the time :)
  75.                      (and providing THE best FSE yet, Emacs!)
  76.       Bill Williford - for letting me use him as a 1.3/68000 guinea pig
  77.       The beta testers - for helping me test, what else!
  78.       
  79.  
  80.    BBS' known to be able to run H&S:
  81.  
  82.       Dialog Pro, BBX, TransAmiga, Starnet, Xenolink, Falcon, Excelsior,
  83.       Nikom
  84.  
  85.       Note to CNet owners: Why H&S doesn't work I don't know.  I'll gladly
  86.       make it work, if someone will provide me with code on how to do raw
  87.       i/o with CNet.
  88.  
  89. Monsters and Such:
  90.  
  91.    Picture file handling has changed since version 1.2.  Due to there being
  92.    100 monsters, I decided to break up the pictures into seperate dirs.
  93.    Currently in use is:
  94.  
  95.    Pics/Dungeon/
  96.       <MonsterName>.(ANS|TXT) - Monsters found in the dungeon
  97.       Cleric.(ANS|TXT) - Cleric found in the dungeon
  98.       Dungeon(N|W|E).(ANS|TXT) - Dungeon room pics
  99.    Pics/Arena/
  100.       <MonsterName>.(ANS|TXT) - Monsters found in the arena
  101.       Summoned Demon.(ANS|TXT) - Demon found in the arena
  102.    Pics/Player/
  103.       <Class Name>.(ANS|TXT) - pictures for players based on class
  104.    Pics/User/
  105.       <PlayerHandle>.(ANS|TXT) - picture for an individual user
  106.                                  (overrides PlayerPic)
  107.  
  108.    The <>should be replace with the name of the monster as seen in config.
  109.    ArenaMonsters are found in the arena (amazing eh?) and DungeonMonsters
  110.    (you guessed it) are found in the dungeon.  The PlayerPic is shown whenever
  111.    you do battle with another user in the arena.
  112.  
  113.    To be added still are the SeaMonsters and User Ships in the Naval section.
  114.  
  115. About Hack & Slash:
  116.  
  117.    Hack & Slash started life (in door form) as XenoRPG for Xenolink BBS.
  118.    XenoRPG was ported from Rob Hurst's RPGBBS program, which was a re-write
  119.    by Rob, of an AppleII BBS called TProBBS.  Rob was nice enough to port
  120.    this game to a Xenolink Door, and has turned the source over to me to
  121.    maintain.  Any changes I make, will be minor at best.  I don't want to
  122.    make major mods to the game, as it will make future merges of new
  123.    features Rob adds much harder.
  124.  
  125.    When I decided to switch from Xenolink, naturally XenoRPG had to come
  126.    with me (my users would have revolted).  The name didn't fit a "generic"
  127.    door, so it was renamed to Hack & Slash, after Rob's BBS.  Since Rob had
  128.    made so many changes to RPGBBS, we felt it was time for a re-port.  Several
  129.    hours, a few gurus, and a few Cokes later, Hack & Slash loaded.  Rob then
  130.    graciously handed the code back to me to continue massaging it for door
  131.    usage.
  132.  
  133. Docs?:
  134.  
  135.    You're reading them!  Docs are sparse, mainly because I hate writing them.
  136.    The game has online documentation for rules of play.  It's suggested
  137.    that you read them.  Any other documentation is sparse at best.  Docs
  138.    should be available for the config utility by the time you read this, and
  139.    the original RPGBBS docs are included for further reading enjoyment.
  140.  
  141. Registration:
  142.  
  143.    H&S is being released as Shareware.  As such, you are required to send in
  144.    a registration fee of $20.
  145.  
  146.    Registration gets you a key which allows you to procede beyind level 15
  147.    up to level 99 (bet you were thinking it was real easy to become Immortal).
  148.    It is after level 15 that magic starts to kick in, and things get harder.
  149.    The game is gaining immense popularity, and is well worth the $20 fee.
  150.    Registration also unlocks the config utility that allows you to edit the
  151.    various data files used by the game.  Just about EVERY attribute of the
  152.    game can be edited with config.  A future version will include a GUI
  153.    config tool.
  154.    
  155.    To register, fill out the included form and return it to the address on
  156.    the form.  Payment methods, as well as methods for obtaining the key are
  157.    listed on the form.
  158.  
  159.    **NOTE**
  160.    Do NOT spend the extra money for FedEx/Overnight mail!!!  This requires
  161.    that I go to the post office to pick it up.  Since my PO hours are from
  162.    8-4 and I leave for work at 7 and get home at 6, I can't get there 'till
  163.    the weekend!  Meaning, you wasted your money!
  164.  
  165. Support:
  166.  
  167.    There are two echos available for H&S, HACK_SLASH and HS_PLAYERS.  The
  168.    first is a SYSOP ONLY echo intended for bug reports, feature suggestions,
  169.    and general chat about the game that might not be appropriate for players.
  170.    Both echos are available from me, or many Amiga BBS' running H&S.  Please
  171.    do not send netmail.  I'm unable to answer everyone's netmail do to the
  172.    overwhelming costs.  If you want to email me, I'm reachable as
  173.    markm@zerbin.dev.cdx.mot.com via the internet.
  174.  
  175. Note to XenoRPG owners:
  176.  
  177.    If you're a registered owner of XenoRPG, there is a utility included called
  178.    X2H.  Read the included docs for usage.  This will convert your XenoRPG.reg
  179.    file to a Hack&Slash.License file for you.
  180.  
  181.